peer模块是Fabric中的核心模块，在Fabric中被称为节点模块，主要负责存储区块链数据、运行链码、背书、提供对外服务接口等。在Fabric中使用最频繁

1 peer模块命令和参数

Usage:
  peer [flags]
  peer [command]

Available Commands:
  chaincode   #操作链码，相关子命令: install|instantiate|invoke|package|query|signpackage|upgrade.
  channel     #操作通道，相关子命令: create|fetch|join|list|update.
  logging     #操作日志，相关子命令: getlevel|setlevel|revertlevels.
  node        #节点服务，相关子命令: start|status.
  version     #打印版本信息

Flags:
      --logging-level string       #日志级别
      --test.coverprofile string   #测试配置文件
      -v, --version                #显示当前服务器的版本

2 peer模块的配置选项

peer模块的配置选项可以通过环境变量或者配置文件的方式来配置,在具体操作中，如果是通过Docker方式启动，一般使用环境变量配置方式。
如果是采用直接命令启动，一般是采用配置文件方式

  • 环境变量的配置示例如下： 
1
2
3
4
5
6
7
8
9
10
11

export set CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock   
export set CORE_VM_DOCKER_HOSTCONFIG_NETWORKMODE=host
export set CORE_LOGGING_LEVEL=DEBUG
export set CORE_PEER_TLS_ENABLED=true
export set CORE_PEER_GOSSIP_USELEADERELECTION=true
export set CORE_PEER_GOSSIP_ORGLEADER=false
export set CORE_PEER_PROFILE_ENABLED=false
export set CORE_PEER_TLS_CERT_FILE=/home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/tls/server.crt
export set CORE_PEER_TLS_KEY_FILE=/home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/tls/server.key
export set CORE_PEER_TLS_ROOTCERT_FILE=/home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/tls/ca.crt
  • 配置文件示例如下：
    core.yaml 配置文件
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90
    91
    92
    93
    94
    95
    96
    97
    98
    99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112
    113
    114
    115
    116
    117
    118
    119
    120
    121
    122
    123
    124
    125
    126
    127
    128
    129
    130
    131
    132
    133
    134
    135
    136
    137
    138
    139
    140
    141
    142
    143
    144
    145
    146
    147
    148
    149
    150
    151
    152
    153
    154
    155
    156
    157
    158
    159
    160
    161
    162
    163
    164
    165
    166
    167
    168
    169
    170
    171
    172
    173
    174
    175
    176
    177
    logging:

        peer:       debug

        cauthdsl:   warning
        gossip:     warning
        ledger:     info
        msp:        warning
        policies:   warning
        grpc:       error

        format: '%{color}%{time:2006-01-02 15:04:05.000 MST} [%{module}] %{shortfunc} -> %{level:.4s} %{id:03x}%{color:reset} %{message}'

    peer:

        id: peer0.org1.simple-network.com
        networkId: dev
        listenAddress: 0.0.0.0:7051
        address: peer0.org1.simple-network.com:7051
        chaincodeListenAddress: 0.0.0.0:7052
        addressAutoDetect: false
        gomaxprocs: -1

        gossip:
            bootstrap: 127.0.0.1:7051
            useLeaderElection: true
            orgLeader: false
            endpoint:
            maxBlockCountToStore: 100
            maxPropagationBurstLatency: 10ms
            maxPropagationBurstSize: 10
            propagateIterations: 1
            propagatePeerNum: 3
            pullInterval: 4s
            pullPeerNum: 3
            requestStateInfoInterval: 4s
            publishStateInfoInterval: 4s
            stateInfoRetentionInterval:
            publishCertPeriod: 10s
            skipBlockVerification: false
            dialTimeout: 3s
            connTimeout: 2s
            recvBuffSize: 20
            sendBuffSize: 200
            digestWaitTime: 1s
            requestWaitTime: 1s
            responseWaitTime: 2s
            aliveTimeInterval: 5s
            aliveExpirationTimeout: 25s
            reconnectInterval: 2
            externalEndpoint: peer0.org1.simpe-network.com:7051
            election:
                startupGracePeriod: 15s
                membershipSampleInterval: 1s
                leaderAliveThreshold: 10s
                leaderElectionDuration: 5s
            pvtData:
                maxPeers: 3
                minAck: 3

        events:
            address: 0.0.0.0:7053
            buffersize: 100
            timeout: 10ms

        tls:
            enabled:  false
            cert:
                file: /home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/tls/server.crt
            key:
                file: /home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/tls/server.key
            rootcert:
                file: /home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/tls/ca.crt

            serverhostoverride:
        fileSystemPath: /home/zym/fabric-ws/simple-demo/peer0-org1/production

        BCCSP:
            Default: SW
            SW:
                Hash: SHA2
                Security: 256
                FileKeyStore:
                    KeyStore:

        mspConfigPath: /home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/msp

        localMspId: Org1MSP

        profile:
            enabled:     false
            listenAddress: 0.0.0.0:6060
        handlers:
            authFilter: "DefaultAuth"
            decorator: "DefaultDecorator"

    vm:

        endpoint: unix:///var/run/docker.sock

        docker:
            tls:
                enabled: false
                ca:
                    file: docker/ca.crt
                cert:
                    file: docker/tls.crt
                key:
                    file: docker/tls.key

            attachStdout: false

            hostConfig:
                NetworkMode: host
                Dns:
                LogConfig:
                    Type: json-file
                    Config:
                        max-size: "50m"
                        max-file: "5"
                Memory: 2147483648

    chaincode:
        peerAddress:

        id:
            path:
            name:

        builder: $(DOCKER_NS)/fabric-ccenv:$(ARCH)-$(PROJECT_VERSION)

        golang:
            runtime: $(BASE_DOCKER_NS)/fabric-baseos:$(ARCH)-$(BASE_VERSION)

        car:
            runtime: $(BASE_DOCKER_NS)/fabric-baseos:$(ARCH)-$(BASE_VERSION)

        java:
            Dockerfile:  |
                from $(DOCKER_NS)/fabric-javaenv:$(ARCH)-$(PROJECT_VERSION)

        startuptimeout: 300s

        executetimeout: 30s

        mode: net

        keepalive: 0

        system:
            cscc: enable
            lscc: enable
            escc: enable
            vscc: enable
            qscc: enable

        logging:
          level:  info
          shim:   warning
          format: '%{color}%{time:2006-01-02 15:04:05.000 MST} [%{module}] %{shortfunc} -> %{level:.4s} %{id:03x}%{color:reset} %{message}'

    ledger:
      blockchain:

      state:
        stateDatabase: goleveldb
        couchDBConfig:
           couchDBAddress: 127.0.0.1:5984
           username:
           password:
           maxRetries: 3
           maxRetriesOnStartup: 10
           requestTimeout: 35s
           queryLimit: 10000

      history:
        enableHistoryDatabase: true

2.1 peer模块配置文件详解

peer的配置文件的默认名为core.yaml，配置文件分为logging、peer、vm、chaincode、ledger这5大部分。各部分相关属性如下所示。

2.1.1 配置文件中logging相关的属性

longing节点定义了peer模块中所有模块的日志级别和日志格式。
日志级别:critical、error、warning、notice、info、debug

1
2
3
4
5
6
7
8
9
10
11
12
logging:

    peer:       debug

    cauthdsl:   warning
    gossip:     warning
    ledger:     info
    msp:        warning
    policies:   warning
    grpc:       error

    format: '%{color}%{time:2006-01-02 15:04:05.000 MST} [%{module}] %{shortfunc} -> %{level:.4s} %{id:03x}%{color:reset} %{message}'

2.1.2 peer相关的配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

peer:
	#节点的编号
    id: peer0.org1.simple-network.com 
    #节点的网络编号
    networkId: dev
    #节点监听地址
    listenAddress: 0.0.0.0:7051
    #节点访问地址
    address: peer0.org1.simple-network.com:7051
    #chaincode监听地址
    chaincodeListenAddress: 0.0.0.0:7052
    #对等端是否应以编程方式确定其地址
    addressAutoDetect: false
    #peer最大可用cpu数， -1表示用默认值
    gomaxprocs: -1

    gossip:
    	#启动节点后向哪些节点发起gossip连接加入网络，本节点需要和所连接节点同属一个组织
        bootstrap: 127.0.0.1:7051
        #是否开启主节点自动选举
        useLeaderElection: true
        #是否将当前节点配置成主节点
        orgLeader: false
        #当前节点在组织内的gossip id，默认为peer.address
        endpoint:
        #保存到内存中的区块个数上限，超过则丢弃
        maxBlockCountToStore: 100
        #保存消息的最大时间，超过则触发转发给其他节点
        maxPropagationBurstLatency: 10ms
        #保存消息最大个数，超过则转发给其他节点
        maxPropagationBurstSize: 10
        #消息转发次数
        propagateIterations: 1
        #消息转发给指定个数的节点
        propagatePeerNum: 3
        #拉去消息时间间隔
        pullInterval: 4s
        #从指定个数的节点拉取消息
        pullPeerNum: 3
        #从节点拉取状态信息消息间隔
        requestStateInfoInterval: 4s
        #向其他节点推送状态信息消息的间隔
        publishStateInfoInterval: 4s
        #状态消息的超时时间
        stateInfoRetentionInterval:
        #启动后在心跳消息中嵌入证书的等待时间
        publishCertPeriod: 10s
        #是否不对区块消息进行校验，默认为false
        skipBlockVerification: false
        #gRPC连接拨号的超时时间
        dialTimeout: 3s
        #建立连接的超时时间
        connTimeout: 2s
        #接收消息缓冲区大小
        recvBuffSize: 20
        #发送消息缓冲区大小
        sendBuffSize: 200
        #处理摘要数据的等待时间
        digestWaitTime: 1s
        #处理nonce数据的等待时间
        requestWaitTime: 1s
        #终止拉取数据的等待时间
        responseWaitTime: 2s
        #心跳发送间隔时间
        aliveTimeInterval: 5s
        #心跳雄安锡的超时时间
        aliveExpirationTimeout: 25s
        #断线后重连的时间间隔
        reconnectInterval: 2
        #节点配组织外感知的地址，默认为空，表示不被外部感知
        externalEndpoint: peer0.org1.simpe-network.com:7051
        election:
            startupGracePeriod: 15s
            membershipSampleInterval: 1s
            leaderAliveThreshold: 10s
            leaderElectionDuration: 5s
        pvtData:
            maxPeers: 3
            minAck: 3

    events:
    	#事件监听地址
        address: 0.0.0.0:7053
        #事件消息缓存数，超过该值则被阻塞
        buffersize: 100
        #队列阻塞的超时时间
        timeout: 10ms

    tls:
        #是否使能tls通信
        enabled:  false
        #服务器身份验证证书
        cert:
            file: /home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/tls/server.crt
        #服务器私钥
        key:
            file: /home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/tls/server.key
        #服务器根证书
        rootcert:
            file: /home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/tls/ca.crt
		#tls握手时指定服务器名称
        serverhostoverride:
    #账本数据文件存放路径
    fileSystemPath: /home/zym/fabric-ws/simple-demo/peer0-org1/production
	#加密机制相关的配置
    BCCSP:
        Default: SW
        SW:
            Hash: SHA2
            Security: 256
            FileKeyStore:
                KeyStore:
	#当前节点的msp路径
    mspConfigPath: /home/zym/fabric-ws/simple-demo/crypto-config/peerOrganizations/org1.simple-network.com/peers/peer0.org1.simple-network.com/msp
	#当前节点名称
    localMspId: Org1MSP
	
    profile:
   		#是否开启了go profile
        enabled:     false
        #go profile获取地址
        listenAddress: 0.0.0.0:6060
    handlers:
        authFilter: "DefaultAuth"
        decorator: "DefaultDecorator"

2.1.3 vm相关的配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

vm:
    #docker服务器的daemon的地址
    endpoint: unix:///var/run/docker.sock
    docker:
        tls:
            #是否启动docker的tls通信
            enabled: false
            ca:
                file: docker/ca.crt
            cert:
                file: docker/tls.crt
            key:
                file: docker/tls.key
        #是否将docker的消息绑定到指定的输出
        attachStdout: false

        hostConfig:
            #chaincode容器的网络命名模式
            NetworkMode: host
            Dns:
            LogConfig:
                #docker日志配置信息
                Type: json-file
                Config:
                    max-size: "50m"
                    max-file: "5"
            Memory: 2147483648

2.1.4 chaincode相关的配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

chaincode:
    #chaincode中peer服务器地址
    peerAddress:

    id:
        path:
        name:
    #本地编译环境为docker镜像
    builder: $(DOCKER_NS)/fabric-ccenv:$(ARCH)-$(PROJECT_VERSION)
    #go语言版本的chaincode的基础镜像
    golang:
        runtime: $(BASE_DOCKER_NS)/fabric-baseos:$(ARCH)-$(BASE_VERSION)
    #car格式的chaincode生成镜像文件时的基础镜像
    car:
        runtime: $(BASE_DOCKER_NS)/fabric-baseos:$(ARCH)-$(BASE_VERSION)
    #java版本的chaincode基础镜像
    java:
        Dockerfile:  |
            from $(DOCKER_NS)/fabric-javaenv:$(ARCH)-$(PROJECT_VERSION)
    #启动chaincode容器时的超时时间，超过这个时间认为启动失败
    startuptimeout: 300s
    #执行Invoke和Init方法时的超时时间，超过这个时间认定执行失败
    executetimeout: 30s
    #chaincode运行模式，net为网络模式，dev为开发模式，dev模式下，可以在容器外运行chaincode
    mode: net
    #peer节点和chaincode节点的心跳时间的保持时间，如果这个之小于等于0，相当于关闭心跳保持
    keepalive: 0
    
    #系统chaincode的开关
    system:
        cscc: enable
        lscc: enable
        escc: enable
        vscc: enable
        qscc: enable
    
    #chaincode的模块日志级别和日志格式
    logging:
      level:  info
      shim:   warning

      format: '%{color}%{time:2006-01-02 15:04:05.000 MST} [%{module}] %{shortfunc} -> %{level:.4s} %{id:03x}%{color:reset} %{message}'

2.1.5 ledger相关的配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

ledger:
  blockchain:
  state:
    #数据库类型，目前支持golevedb和CouchDB
    stateDatabase: goleveldb
    #如果上面配置了CouchDB，则下面couchDB相关的配置生效
    couchDBConfig:
       couchDBAddress: 127.0.0.1:5984
       username:
       password:
       maxRetries: 3
       maxRetriesOnStartup: 10
       requestTimeout: 35s
       queryLimit: 10000
    
  #是否使能历史状态数据库
  history:
    enableHistoryDatabase: true